home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / graphics / irun11.zip / IMAGERUN.TXT < prev    next >
Text File  |  1995-01-15  |  21KB  |  551 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                              Image::Runner(tm)
  9.                             -------------------
  10.  
  11.            developers' pcx display utility for DOS applications
  12.  
  13.  
  14.  
  15.  
  16.                         a product of RCCO Research
  17.  
  18.  
  19.  
  20. Capabilities
  21. -------------
  22. Image::Runner(tm) is basically a simple utility that allows DOS executable
  23. applications to display a developer- or enduser-designed VGA .pcx file from
  24. anywhere within the application.  It is provided in form of a small,
  25. efficient, fast .exe meant to be called with the system command processor
  26. in the host application.  Image::Runner will display 640x480x16 VGA pcx
  27. images that may contain static graphs, artwork, or other graphic objects
  28. needed in an application.
  29.  
  30. While it has always been possible to execute other programs from within an
  31. application that will display such images, Image::Runner provides advantages
  32. for the commercial developer in that, upon payment of a very nominal
  33. registration fee, it may included and distributed with multiple applications
  34. legally and without further license, restriction, or payment of runtime
  35. royalties.
  36.  
  37. Image::Runner may be called multiple times from within an application and
  38. adds little overhead to the executable sequence.  The called pcx image
  39. displays until the end-user presses a key, then returns quickly and
  40. efficiently to the calling program.
  41.  
  42. Image::Runner may be used with most traditional MS-DOS language executables,
  43. including those created with CA-Clipper, Borland Turbo Pascal, QuickBASIC,
  44. PowerBasic, Visual Basic(tm) for DOS, dBase, Clarion, C, etc.   It is very
  45. small, very efficient, and executes cleanly and quickly from within any DOS
  46. program; its small file size (about 29k, not compressed) provides for
  47. minimal space usage on distribution disks and is non-obtrusive and very
  48. discrete to the end-user as to its purpose.  (An attempt by an end-user to
  49. execute '_i_.exe' without knowledge of the proper command line parameter
  50. will yield nothing other than an exit back to the DOS prompt.)
  51.  
  52. Image::Runner image displays will run under both DOS and Windows.  The chief
  53. advantages, aside from the displays themselves, are both low cost and method
  54. of acquisition.  The copy included herewith is a fully-functional evaluation
  55. copy available easily and universally through the user-supported software
  56. marketplace.
  57.  
  58.  
  59.  
  60.  
  61. IRDemo.exe and the sample files
  62. --------------------------------
  63. To run the demonstration files included in this package (IRDEMO.EXE and 2
  64. sample pcx files), copy all pertinent files (including _I_.EXE) to a
  65. directory on the hard disk (or a ram drive), and simply execute
  66.  
  67.                            IRDEMO <enter>
  68.  
  69. from the DOS prompt.  IRDEMO is a C language program that will call the
  70. Image::Runner utility (ie, _i_.exe) twice using the system() function;
  71. other languages will call a similar instruction (see below).
  72.  
  73. For tolerable viewing results, do not run the demo from a floppy drive.
  74.  
  75.  
  76.  
  77.  
  78. Preparation of images
  79. ----------------------
  80. Image::Runner is particularly effective for software developers preparing
  81. static graphs, artwork, or other images for their applications, in that they
  82. can easily capture usable materials with programs like Hijaak(tm) for Windows
  83. and modify or create them in editing programs such as Windows(tm) Paintbrush.
  84. Image names may also be selected by the end-user via a menu selection and
  85. passed to to the calling sequence with the appropriate string.
  86.  
  87. The only requirement is that images must be finally saved in 640x480 16-
  88. color VGA .pcx file format.  If you are doing image preparation in Windows,
  89. you will have to load a 16-color video driver for 640x480 VGA in order to
  90. prepare proper images.  This format is used since it is the most universal
  91. that will allow presentations to be viewed on as many DOS and/or Windows
  92. VGA systems as possible.  Do not build your images with 256 or more colors
  93. as they will not display with Image::Runner.  The end-user should then
  94. be able to properly display using any VGA card and driver with 16 or more
  95. colors; it is only during the preparation and saving of .pcx images that you
  96. must use a 640x480x16 driver.
  97.  
  98. We have observed excellent, consistent results with using a program such as
  99. Hijaak(tm) for Windows to capture entire DOS or Windows screens, or selected
  100. areas of screens, or a particular window on a full Windows screen.  The pre-
  101. parer then does final editing, adding text, drawing lines or other objects,
  102. in a drawing program.  For example, the two sample pcx images provided with
  103. this package were done entirely in the program that comes free with Win-
  104. dows(tm) 3.1:  Paintbrush.  The inset picture in _ADMIN1.PCX was captured
  105. from a black and white line drawing with a hand scanner and edited in Paint-
  106. brush.
  107.  
  108. Other graphics programs are likely to provide compatible material, but they
  109. must be tried on a test basis with Image::Runner.  The two programs mentioned
  110. above work well for most users, are widely available, and do not require
  111. great technical or artistic ability.  Scanned images will be effective in
  112. Image::Runner if they are saved in the proper format.  If one format you are
  113. using seems not workable, try saving that image in another program, such as
  114. Windows Paintbrush; we have often found that certain images work better when
  115. converted or simply saved in another program's format even though they may
  116. use the same .pcx extension.
  117.  
  118. When attempting to use monochrome pcx files, resave them as 16-color
  119. 640x480 VGA pcx files.  Even though the appearance may remain the same,
  120. they will be saved in a format usable by Image::Runner.
  121.  
  122. Once you find the right combination of steps to produce pcx file formats
  123. consistently usable by Image::Runner, you will save a great deal of time
  124. and effort by always using that combination in future applications.
  125.  
  126.  
  127.  
  128.  
  129. Running Image::Runner from within your application
  130. ---------------------------------------------------
  131. The basic requirement is that the image files and the related executables
  132. be placed in the same directory on a hard drive.   Alternatively, the
  133. Image::Runnner executable may be in the path, and the .pcx files may be
  134. local in any directory from which you wish the images to display.  You
  135. should advise end-users against running your application from a floppy
  136. disk, due to the slowness of building the on-screen image when reading
  137. from a diskette.
  138.  
  139. Your end-users will certainly need VGA graphics capabilities to view your
  140. images.  If a user attempts execution on a non-VGA-capable system, a simple
  141. screen will display the message
  142.  
  143.  
  144.  
  145.  
  146.                    ╔════════════════════════════════════════╗
  147.                    ║                                        ║
  148.                    ║  Image display requires VGA graphics.  ║
  149.                    ║              (640x480x16)              ║
  150.                    ║                                        ║
  151.                    ╚════════════════════════════════════════╝
  152.  
  153.  
  154.  
  155.  
  156.  
  157. and return to the calling program after a 2-second delay.
  158.  
  159.  
  160. The calling sequence for all languages will consist of the traditional
  161. instruction for utilizing the command processor from within the program
  162. plus an indication of the command line parameters:
  163.  
  164.                            _i_ x.pcx
  165.  
  166. where '_i_' indicates the _I_.EXE Image::Runner utility, and 'x.pcx'
  167. is the full filename (including extension) of the 640x480x16 pcx image
  168. you wish to display.  The image will not display without specifying the
  169. .pcx extension.
  170.  
  171. You need not specify a clearscreen before or after the image display; a
  172. clearscreen is automatic with an Image::Runner call.  Therefore, it may be
  173. desirable to save and restore (or recreate) the screen existing at the time
  174. of the call.  Also, if the non-VGA text screen is displayed (see above),
  175. please note that the text cursor is momentarily turned off and then turned
  176. on again as the screen exits; if, by chance, your program was originally
  177. executing with the text cursor turned off, you may need to turn it off
  178. again upon reentry.
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185. Specific languages example calls
  186. ---------------------------------
  187. The following examples provide typical calls to display a 640x480x16 pcx
  188. image from within a program.
  189.  
  190.  
  191. QuickBASIC, PowerBasic, Visual Basic for DOS
  192. ---------------------------------------------
  193.  
  194.    RUN "_I_ X.PCX"
  195.  
  196.  
  197.  
  198.  
  199. dBase and Clipper S '87
  200. ------------------------
  201.  
  202.    RUN _I_ X.PCX
  203.  
  204.  
  205.  
  206.  
  207.  
  208. CA-Clipper
  209. -----------
  210.  
  211.    run _i_ x.pcx
  212.  
  213.    // may also be overlayed with Blinker's
  214.  
  215.    //       SwpRunCmd("_i_ x.pcx")
  216.  
  217.    // although this may be overkill for a simple
  218.    // utility such as Image::Runner.
  219.  
  220.  
  221.  
  222.  
  223.  
  224. Clarion
  225. --------
  226.  
  227.    OPEN(SCREEN)
  228.    RUN('_I_ X.PCX')
  229.    CLOSE(SCREEN)
  230.    RETURN
  231.  
  232.  
  233.  
  234.  
  235. Turbo Pascal
  236. -------------
  237. This is one suggestion for Turbo Pascal use; most Pascal developers will
  238. have their own preferred method of executing a DOS program from within an
  239. application.
  240.  
  241.  
  242. {$M $8192,0,0 }  { stacks spec, used by drun procedure }
  243. uses crt, dos;
  244.  
  245. procedure drun(what : string);
  246.    begin
  247.       swapvectors;
  248.       exec(getenv('COMSPEC'), '/C ' + what);
  249.       swapvectors;
  250.       if DosError <> 0 then
  251.          WriteLn('Could not execute COMMAND.COM');
  252.       WriteLn;
  253.    end;
  254.  
  255.  
  256. { call the image display within the program: }
  257.  
  258.    drun('_I_ X.PCX');
  259.  
  260.  
  261.  
  262.  
  263. C programs
  264. -----------
  265. Although there are several excellent ways to call DOS processes,
  266. including the many variants of SPAWN and EXEC, we provide herewith
  267. the simple and direct use of the system() function.
  268.  
  269.  
  270.    #include <process.h>   /*  or stdlib.h  */
  271.  
  272.    ...
  273.  
  274.    system("_I_ X.PCX");
  275.  
  276.  
  277. (The sample demo program included in this package uses the system()
  278. function.)
  279.  
  280.  
  281.  
  282. Other development environments will have equivalent methods for executing
  283. a DOS executable program via the command processor; consult the appropriate
  284. reference manual for specific procedures.
  285.  
  286.  
  287.  
  288. Batch files
  289. ------------
  290.  
  291.    @echo off
  292.    _i_ x.pcx
  293.  
  294.  
  295.  
  296.  
  297. From the DOS system prompt
  298. ---------------------------
  299.  
  300.    C:\DIR\_i_ x.pcx <enter>
  301.  
  302.  
  303.  
  304.  
  305.  
  306. In all instances, the calling of '_i_.exe' and the resulting image display
  307. do not require a great deal of memory and therefore generally may be used
  308. in a typical 640k DOS memory environment.
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315. Troubleshooting
  316. ----------------
  317. The only caveat we might offer with this program is that if you find that
  318. your images do not display, or do not display properly, it is probably
  319. because they have been created or saved in a format that may only be
  320. slightly incompatible with that which Image::Runner requires.  Before
  321. you decide that the Image::Runner program is not usable in such instances,
  322. try the suggestion given before for re-saving your .pcx files in another
  323. graphics program.  Most image-editing programs will read files in several
  324. formats, and often allow conversions, or perhaps will save them in a later
  325. .pcx format that will work with applications such as Image::Runner.
  326.  
  327. Also, make certain that images are saved in 640x480 by 16-color format by
  328. using the proper software and/or video drivers to handle the format.
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335. Program Requirements
  336. ---------------------
  337. The requirements for running Image::Runner include a DOS-compatible PC
  338. with 512k memory, VGA graphics capability, and a hard drive.  DOS 3.1 (or
  339. later) or Windows 3.x (or later) should be utilized.
  340.  
  341.  
  342.  
  343.  
  344. The Unregistered Evaluation Copy
  345. ---------------------------------
  346. The unregistered version of this program is intended for use in evaluation
  347. situations.  It may be used for ninety (90) days within your own organ-
  348. ization by persons that have knowledge and understanding of the fact that
  349. this is an unregistered evaluation copy.
  350.  
  351. The payment of the $24.95 purchase price for a registered copy of this
  352. program will allow license for a single user to make use of the program for
  353. purposes that are traditionally accepted for software utilities of this
  354. type.  Additional site license fees of $10.00 per user may be paid at the
  355. time of registration, or any time in the future after initial registration
  356. at the then current license fee in effect.  There are no runtime royalties
  357. involved in the distribution of your materials utilizing a duly registered
  358. copy of Image::Runner.
  359.  
  360. The license and authorized registration shall not be construed as being
  361. in effect until direct payment has been received by RCCO Research and an
  362. authorized, registered copy has been sent in the registered user's/users'
  363. name(s).
  364.  
  365.  
  366.  
  367.  
  368. The Registered Version of Image::Runner
  369. --------------------------------------------
  370. The registered copy performs the same execution as the evaluation copy, only
  371. without the unregistered copy delay at the close of the VGA display.
  372.  
  373. Documentation for the registered version is an on-disk text file, similar to
  374. the present format.
  375.  
  376.  
  377.  
  378.  
  379.  
  380. Licensing Information
  381. ----------------------
  382. This program is licensed and supplied as is, without any warranty.  To the 
  383. extent permitted under applicable law, RCCO Research Associates disclaims 
  384. all warranties, either expressed or implied, with respect to this software 
  385. program, its quality, performance, merchantability, or fitness for any 
  386. particular purpose.
  387.  
  388. In particular, this software program is not guaranteed to prevent or detect
  389. damage to your data or programs.  In no event shall RCCO Research Associates
  390. be liable for any claims for lost profits or any damage, including, but not
  391. limited to, special, incidental, consequential or other damage (including, 
  392. without limitation, damages for loss of business profits, business interrup-
  393. tion, loss of business information, or other pecuniary loss) arising out of
  394. the use of or inability to use this RCCO Research Associates product, even
  395. if RCCO Research Associates has been advised of the possibility of such
  396. damages.  Some states do not allow the exclusion or limitation of incidental
  397. or consequential damages, so the above limitation or exclusion may not apply
  398. to you.  In no case shall RCCO Research Associates's liability exceed the
  399. license fees paid for the right to use the licensed version of the software. 
  400.  
  401. The license agreement and warranty shall be construed, interpreted and
  402. governed by the laws of the state of Tennessee.
  403.  
  404. This software program is protected under the Copyright Laws of the United 
  405. States of America and all applicable International Copyright Conventions.  
  406. Makers and/or users of illegal or unauthorized copies of the registered 
  407. version are subject to prosecution under these laws.
  408.  
  409. The name  Image::Runner(tm)  is a trademark of RCCO Research Associates.
  410. Windows(tm) is a trademark of Microsoft Corporation.  Other trade names
  411. referenced herein are either trademarks or registered trademarks of their
  412. respective companies.
  413.  
  414.  
  415.  
  416.  
  417.  
  418. Registration Notes
  419. -------------------
  420. Registration will obtain a copy of the most recent authorized version and
  421. provide legal authorization for continued use of the program after the
  422. ninety-day (90-day) evaluation period.
  423.  
  424. To obtain a registered copy, you must mail an advance-payment registration
  425. fee of U.S. $24.95 + $2.55 shipping/handling ($7.05 non-U.S. shipping/
  426. handling, $4.05 for Canada) directly to RCCO Research.  Additional users
  427. are $10.00 per user.  Payment is to be made by check or money order only,
  428. please.  We require payment with order so that prices and fees may be kept
  429. as reasonable as possible; this policy has worked well for us in recent
  430. years, as we observe increased registration on products that are reasonably
  431. priced.  For telephone and credit card orders, see Additional Ordering
  432. Options note below.
  433.  
  434. An invoice will be included with your order, showing the registered serial
  435. number(s) applicable to the purchase.  We can provide a pro forma invoice
  436. to those corporations or institutions that require same before payment can
  437. be issued; shipment will be made promptly upon receipt of payment.  Prices
  438. and/or registration and/or license fees are subject to change.
  439.  
  440. Tennessee clients please include the required 8.5% sales tax on both the
  441. product amount and shipping/handling as mandated by the state.
  442.  
  443. International clients must pay by check or money order in U.S. dollars, drawn
  444. on a U.S. bank or the U.S. branch of an international bank.  Please realize
  445. that international postal money orders are considerably delayed through the
  446. postal systems and may not be the most expedient way of relaying payment.  An
  447. often-used form of payment consists of obtaining a dollar-denominated money
  448. order from the local American Express office which you may then airmail to
  449. us along with your order.  International orders are dispatched promptly
  450. when using a credit card order as outlined below, under Additional Ordering
  451. Options.
  452.  
  453. Please indicate program name and current version number on your order; you
  454. may use the Order.frm file provided in this package, or simply send a note
  455. or letter with your name, organization name, address, program name and
  456. version, number of users being licensed, and remittance.  Your comments on
  457. our programs are welcomed.
  458.  
  459.  
  460.  
  461.  
  462.      Additional Ordering Options:
  463.      ----------------------------------------------------------------------
  464.      CREDIT CARD ORDERS ONLY -
  465.      You may order a registered copy of this RCCO Research program
  466.      with MC, Visa, Amex, or Discover from PsL, Public (software)
  467.      Library of Houston, Texas by calling 800-242-4775 or 713-524-6394,
  468.      or by FAX to 713-524-6398, or by CompuServe E-mail to 71355,470.
  469.      You may also mail credit card orders to PsL at P.O. Box 35705,
  470.      Houston, TX 77235-5705.  PsL's item/product number for
  471.      Image::Runner is #11623.
  472.  
  473.      THE ABOVE NUMBERS ARE FOR ORDERS ONLY.
  474.      Any questions about the status of the shipment of the order,
  475.      registration options, product details, technical support, volume
  476.      discounts, dealer pricing, site licenses, etc. must be directed in
  477.      writing to RCCO Research, P.O. Box 196, Gatlinburg, TN 37738.  To
  478.      ensure that you get the fastest possible delivery of your registered
  479.      copy, PsL will notify us the day of your order and we will promptly
  480.      ship the materials directly to you.  There are no additional fees
  481.      for ordering by credit card.
  482.  
  483.      Your credit card number is *not* transmitted to RCCO Research, but
  484.      rather is processed by PsL as part of their software registration
  485.      service.
  486.  
  487.      The above service is made available as a convenience to client
  488.      individuals who feel comfortable with ordering by telephone and
  489.      with a credit card.  Established concerns may prefer to order
  490.      directly from RCCO Research with the company's own business check.
  491.  
  492.      The PsL staff cannot answer non-order inquiries.
  493.      ----------------------------------------------------------------------
  494.  
  495.  
  496.  
  497.  
  498.  
  499. Additional Information
  500. -----------------------
  501. If you have any comments or questions regarding this program after (or with)
  502. registration, please send them to:
  503.  
  504.                               RCCO Research Associates
  505.                               P. O. Box 196
  506.                               Gatlinburg, TN 37738  (U.S.A.)
  507.  
  508. Please include your phone (day & evening) and fax (if any) numbers as well
  509. as your mailing address (and CompuServe number / Internet address, if any)
  510. on ALL written communications.  Please indicate the serial number from your
  511. registered copy of the program as well as your CustID number.  Our E-mail
  512. addresses are provided to registered users along with the invoice.
  513.  
  514.  
  515. RCCO Research is the publisher of Visible::Setup(tm) (a developers'
  516. installation utility for DOS applications used widely in many parts of the
  517. world), as well as several other popular development tools.  Please consult
  518. your favorite user-supported software source for the availability of these
  519. and other RCCO Research DOS and Windows programs.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526. Image::Runner(tm)
  527. ------------------
  528. developers' pcx display utility for DOS applications
  529.  
  530.  
  531.  
  532. (C) Copyright 1994-95 RCCO Research Associates
  533. All Rights Reserved under International Conventions
  534. Product of U.S.A.
  535.  
  536.  
  537.  
  538. RCCO Research Associates
  539. Post Office Box 196
  540. Gatlinburg, Tennessee 37738 (U.S.A.)
  541.  
  542.  
  543.  
  544.  
  545.                      ┌─────────────────────────────────┐
  546.                      │     RCCO Research Associates    │
  547.                      │ Technical Publishers, Est. 1965 │
  548.                      └─────────────────────────────────┘
  549.  
  550.  
  551.